home *** CD-ROM | disk | FTP | other *** search
/ Bible Heaven / Bible Heaven.iso / misc / bibday01 / bibday.doc < prev    next >
Text File  |  1993-11-18  |  13KB  |  289 lines
  1. BIBDAY - Bible verse of the day program for DOS - (c) 1993 by Robert Woeger
  2.                                                         All rights reserved
  3.  
  4. *** Summary of BIBDAY ***
  5.  
  6. BIBDAY Version 1.0 is a useful Bible Verse of the day program.  It displays
  7. a random Bible Verse each time it is run.  It will help to brighten your day
  8. and pick you up.  You can set the BIBDAY program to run every time you boot
  9. your system if you like.  That way your PC will greet you with a message
  10. of encouragement and inspiration each time you turn it on.  You can also
  11. use it to display a verse when you run certain applications or batch files
  12. also.  It has many uses.  You can configure the color of the text of the
  13. Bible Verses also.  You can optionally have it clear the screen before the
  14. verses are displayed.  You can add your own Bible Verses by using a standard
  15. ASCII text editor such as EDLIN or EDIT.  That way you can see your
  16. favorite verses each time you run BIBDAY.  You can choose to pause the screen
  17. after the verse is displayed or let the screen scroll.
  18.  
  19.  
  20.  
  21.  
  22.  
  23. *** Distribution of BIBDAY/Cost of BIBDAY ***
  24.  
  25. This version, BIBDAY 1.0, is distributed using the shareware software
  26. distribution method.  The author, Robert Woeger, owns the copyright on this
  27. program and will allow anyone to distribute the BIBDAY program as long as the
  28. following simple rules are followed:
  29.  
  30.         1)  All people are encouraged to give copies of this shareware
  31.         version of BIBDAY away to others.  You may charge a reasonable disk
  32.         duplication fee if you are a shareware vendor (not to exceed $8/disk).
  33.         CD-ROM publishers are free to include BIBDAY on their shareware
  34.         CD-ROMs.  On-line services and bulletin board systems may freely
  35.         distribute the shareware version of BIBDAY even if they charge an
  36.         access fee to use their systems.  You may not sell copies of BIBDAY -
  37.         only the author may receive payment for use of BIBDAY.
  38.        
  39.         2)  You may use this program for a trial period not to exceed 30
  40.         days.  At the end of the 30 day trial period you must either pay
  41.         the author, Robert Woeger, for the right to continue to use the
  42.         program or stop using BIBDAY altogether.  Upon payment to the author
  43.         you will receive a special registered version of BIBDAY that does not
  44.         have the "Unregistered shareware version line" at the top of the
  45.         screen, plus you will receive the latest version of BIBDAY.  Also
  46.         you will know that you have done the right moral and legal thing.
  47.         As the Bible says "For the worker is worth his wages" Luke 10:7, and
  48.         the author has the legal right to expect payment for his work in
  49.         writing this program.
  50.  
  51.         3)  Tell others about BIBDAY!  Give it away to help spread God's Word
  52.         into other people's lives.  If you or your church or ministry would
  53.         like a special registered version of BIBDAY to distribute as part of
  54.         your evangelism or fund raising program(s) please contact the author
  55.         for details.  I am very receptive to working with ministries and
  56.         churches about licensing BIBDAY for your fund-raising or evangelism
  57.         needs.  This special registered version of BIBDAY I have available
  58.         is a pre-paid license so people you send it to or give it to don't
  59.         have to pay me an additional shareware fee.
  60.  
  61.         4)  You MAY NOT distribute any other versions of BIBDAY to others
  62.         (i.e. Registered version, Special Evangelism version, etc.) unless
  63.         you have a special license from the author to do so.  This shareware
  64.         version is the ONLY version that you may distribute.  If the logo on
  65.         the top of the display says registered copy, please do not distribute
  66.         it.  Thank You.
  67.  
  68.         5) This program and all its files are distributed on an "AS IS" basis
  69.         with no warranties provided.  The author has tested the programs on
  70.         his PC but can not vouch to how they will act on your computer.  The
  71.         author will in no way be liable for any accidental damage or misuse
  72.         caused by these programs.
  73.  
  74.         6)  When you distribute this shareware version of BIBDAY to others,
  75.         you MUST ONLY distribute the original files that came with BIBDAY.
  76.         You MAY NOT add, remove, or modify any of the files you give to
  77.         others!  That includes the BIBVERSE.DAY text verse file!  You may
  78.         modify the BIBVERSE.DAY file for use on your own PC and for use
  79.         on machines you have a registered licensed copy of BIBDAY for, but
  80.         you MAY NOT distribute modified copies of BIBVERSE.DAY or the other
  81.         program files included with the BIBDAY package.  Disk vendors may add
  82.         their own supplemental documentation or information files to the disk
  83.         but may not modify or delete any of the original distribution files.
  84.  
  85.  
  86.  
  87.  
  88. *** Note:  The following references are made immediately following the
  89. Bible verse reference to specify which version of the Bible the verse is
  90. taken from.  Each version except the King James Version is copyrighted
  91. and is used by permission of the respective publisher of that version.
  92.  
  93. [KJV] - King James Version
  94. [NKJV] - New King James Version
  95. [NIV] - New International Version
  96.  
  97.  
  98. You may contact the author in the following ways:
  99.  
  100. Mail:  Robert Woeger, 2423 Hagerman St., Colorado Springs, CO 80904-3228  USA
  101. Phone:  (719) 471-8306  days or evenings
  102. CompuServe Email address:  71204,605
  103. Internet Email:  71204.605@compuserve.com
  104.  
  105. See the PAYFORME.DOC file to register (pay for) your copy of BIBDAY.
  106.  
  107. The BIBDAY program is shipping in both DOS and native OS/2 versions.  In
  108. the near future a Windows specific version is planned to be released.  Look
  109. on your favorite BBS for new versions of all the BIBDAY programs.
  110.  
  111. Filename formats for distribution are currently:
  112.  
  113. BIBDAYD1.ZIP    Bibday Version 1 -  DOS Specific version (this package)
  114. BIBDAYO1.ZIP    Bibday Version 1 -  OS/2 Specific version (another separate
  115.                                                            package)
  116. BIBDAYW1.ZIP    Future Windows version of BIBDAY.
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124. *** Documentation for BIBDAY's features and how to set it up ***
  125.  
  126. BIBDAY is very easy to set up.  It is all ready to run and go as is.  You
  127. should have the following files on your disk when you receive BIBDAY (DOS
  128. version):
  129.  
  130. BIBDAY.EXE  -  run this program  -  main BIBDAY verse display program
  131. BIBVERSE.DAY  -  text ASCII file containing verses to be displayed
  132. BIBDAY.DOC  -  Documentation (this file) for BIBDAY
  133. BIBCOUNT.EXE  -  simple utility to run to count the number of verses in your
  134.                  BIBVERSE.DAY file  (useful when you have added some verses)
  135. PAYFORME.DOC  -  text file to be used to order a registered copy of BIBDAY
  136.  
  137. If you obtained BIBDAY as a .ZIP format, you will need to unzip it first to
  138. get the above files.
  139.  
  140.  
  141. BIBDAY may be run by simply typing the word BIBDAY in the directory where
  142. both the BIBDAY.EXE program and the BIBVERSE.DAY file reside.
  143.  
  144. BIBDAY.EXE may also be called from any other directory, batch file, your
  145. AUTOEXEC.BAT file, etc.   Simply specify the program in your PATH statement
  146. or type the complete drive and path to the directory where BIBDAY.EXE resides.
  147.  
  148. BIBDAY.EXE has an optional parameter that can be specified to tell BIBDAY
  149. where its BIBVERSE.DAY file is located.  This is useful so you don't have
  150. to have the BIBVERSE.DAY file in the same path/directory where BIBDAY.EXE is.
  151. Simply use the following format:
  152.  
  153.         BIBDAY C:\BIBDAY
  154.  
  155. This command will call up BIBDAY and use the BIBVERSE.DAY file from the
  156. C:\BIBDAY directory.  This is useful if you have different BIBVERSE.DAY files
  157. you want displayed (place them in different directories).  Or you can use
  158. the above line in a batch file to call a special verse file.  Note:  DO NOT
  159. specify the file name as a parameter (only the drive and pathname).  BIBDAY
  160. always looks for a file called BIBVERSE.DAY in the directory you specify.
  161.  
  162. To have a verse be displayed every time you boot up your PC:
  163.  
  164. Place the following line as the last line in your AUTOEXEC.BAT file which
  165. resides in the root directory of your boot drive (usually C:\):
  166.  
  167. C:\BIBDAY\BIBDAY C:\BIBDAY
  168.  
  169. assuming that you made a subdirectory on drive C named BIBDAY that contains
  170. both the BIBDAY.EXE program and the BIBVERSE.DAY file.
  171.  
  172.  
  173. To make BIBDAY PAUSE at end of its verse display:
  174. Create a small batch file using an ASCII text editor which runs BIBDAY then
  175. executes the PAUSE command as the next line.  When run, the batch file will
  176. run BIBDAY to display a verse, then will say "Press any key to continue" and
  177. wait for a key to be pressed.  Sample batch file to do this:
  178.  
  179. C:\BIBDAY\BIBDAY C:\BIBDAY
  180. PAUSE
  181.  
  182.  
  183.  
  184. Modify the COLORS of the verse text:
  185. You may easily modify the colors that BIBDAY uses to display the text of your
  186. verses.  Using an ASCII text editor change line 3 of the BIBVERSE.DAY file
  187. to be a number from the list below representing the color you want used.
  188. Valid color code numbers are 0 through 31.  Place the number on line 3 by
  189. itself (no other data).  Example:    14
  190. This would use color 14 (Yellow) to display the Bible verse text.  Choose
  191. the color from the following color code table:
  192.  
  193. 0 = Black  (be careful or you may not see black text on a black background)
  194. 1 = Blue   (colors 1-6 are dark versions of colors 9-14)
  195. 2 = Green
  196. 3 = Aqua
  197. 4 = Red
  198. 5 = Purple
  199. 6 = Amber
  200. 7 = White
  201. 8 = Gray
  202. 9 = Light blue
  203. 10 = Light green
  204. 11 = Light aqua
  205. 12 = Light red
  206. 13 = Light purple
  207. 14 = Yellow
  208. 15 = Bright White
  209.  
  210. Colors 16 to 31 are BLINKING versions of the corresponding 0-15 colors.
  211. Example 16 = Blinking Black, 17 = Blinking Blue, 31 = Blinking Bright White.
  212.  
  213. Do not use a color code greater than 31 or less than 0!
  214. Also make sure the color code is on line 3 of the BIBVERSE.DAY file!
  215. If you get all black text then make sure you DO NOT have any invalid text
  216. or number on line 3, it must just have the color number and nothing else.
  217.  
  218.  
  219.  
  220.  
  221. To ADD/DELETE verses from the verse file:
  222. You must make sure that line 4 of the BIBVERSE.TXT file has a single number
  223. alone on the line (nothing else) and it contains the maximum number of
  224. verses in the BIBVERSE.DAY file.  This number starts at 129 when you get
  225. BIBDAY as there are 129 verses in the file.  If you add or delete any verses,
  226. you must manually change this number to reflect the number of verses there
  227. are, or else BIBDAY will not know the correct number of verses to use.  You
  228. may run the BIBCOUNT.EXE program to determine the number of valid verses in
  229. the BIBVERSE.DAY file.  The BIBCOUNT program looks for the BIBVERSE.DAY file
  230. in the current directory ONLY.  If it does not find the BIBVERSE.DAY file,
  231. you will get a file not found error message.
  232.  
  233. So to add verses:
  234. Add as many verses as you like in the following format:
  235. verse text may be as many lines as you like, then put a @ character on a line
  236. by itself immediately following each new verse.  This tells BIBDAY when the
  237. end of each verse is.  Make sure you add one @ character per end of verse.
  238. Save your updated BIBVERSE.DAY file and run BIBCOUNT to count the number of
  239. verses.  Then modify Line 4 of the BIBVERSE.DAY to reflect the new number of
  240. verses.  Now you are ready to run BIBDAY with the new verses.
  241.  
  242.  
  243.  
  244. To ENABLE or DISABLE CLEAR SCREEN option:
  245. BIBDAY allows you to either ENABLE CLS or have no CLS before the verse text
  246. is displayed.  This is personal preference and depends when you run BIBDAY.
  247. This option is specified in Line 2 of the BIBVERSE.DAY file.  On line 2 put
  248. either CLS or NOCLS.  These are case sensative, they must be upper case only.
  249. Put CLS by itself on line 2 to clear the screen before the verse is displayed
  250. and put NOCLS to not clear the screen before the verse is displayed.
  251.  
  252.  
  253.  
  254. Format of your BIBVERSE.DAY file(s):
  255.  
  256. Line 1         Copyright message - DO NOT CHANGE THIS LINE
  257. Line 2         CLS    or    NOCLS   (left justified)
  258. Line 3         14                         Color number only (no text)
  259. Line 4         129                        Maximum number of verses (number)
  260. Line 5-end     Verse text
  261.  
  262. ***  Make sure your put an @ character on a line by itself after every
  263. verse to be displayed when adding new verses to the BIBVERSE.DAY file.
  264.  
  265.  
  266.  
  267.  
  268. --------
  269. This BIBDAY program is dedicated to GOD who has given me new life and
  270. salvation through His Son, Jesus Christ.  It is also dedicated to my loving
  271. wife, Jodi.  Without her help and support this program would not have been
  272. possible.  It is my desire that you would be touched by the Word of God
  273. presented by these scripture verses, and desire to know the Lord and Saviour,
  274. Jesus Christ.
  275. ---------
  276.  
  277.  
  278.  
  279. Please send your comments, registrations, inquiries to the author:
  280.  
  281. Robert Woeger
  282. 2423 Hagerman St.
  283. Colorado Springs, CO 80904-3328  USA         Phone (719) 471-8306
  284.                                              CompuServe 71204, 605
  285.  
  286. Please share this shareware version with others and register it yourself
  287. if you like it (see PAYFORME.DOC to register).  Thank You! - Robert Woeger
  288.  
  289.